    Gin Rummy Intro.txt          revise b+ 2020-10-19

Gin Rummy is a 52 card game between 2 players. The object 
is to Meld (match cards into sets) in a 10 card hand. A 
Meld set is either 3 or 4 of-a-kind called a Group set or
a Straight set = a sequence of 3 or more cards all of the
same suit. Deadwood are the cards or points left in a hand
not melded. For points, an Ace counts as 1 (and can not be
linked with a King for straights), face cards count as 10
and the remaining have the number value of the card. 

Play: The game against the computer starts when both you
and computer are dealt 10 cards and the human has first
choice to pick from the deck or the face up card, the
beginning of the discard pile. Each round after that, the 
human and computer take turns picking a card from either
the deck or discard pile and discards from es hand, keeping
hands at 10 cards, matching up cards and reducing the 
deadwood points they are holding. 

This goes on until: 
1. One signals Gin, all cards have been melded and there is
   0 deadwood points left in their hand.
2. One Knocks, the knocker must have 10 or less in deadwood
   points. This is optional and the winner of a knock is the
   one with less deadwood points. This is the 2nd way for
   laying down cards and scoring.  
3. When there is only 2 cards left in deck, the round is
   null and players start over with no changes in score.

A game is won when a player has scored 500 points or more.

Scoring:
Gin = 15 + winner Meld Points + loser Deadwood Points
Knock = winner Meld Points + loser Deadwood Points

Knocking: Knocking is an option if you have 10 or less 
points. You probably will want to knock as soon as you have
10 or less to catch the other player with his Deadwood
points high to add to your score. But you could go for the
added 15 points for Gin. There are different variations of
what is done after a knock but here you just get your Meld
plus their Deadwood points if you have less deadwood.

Rules to Gin Rummy are not hard and fast specially the
scoring, I mainly followed these REFERENCES, taking some
coding license. 
1. https://bicyclecards.com/how-to-play/gin-rummy/
2. https://playingcarddecks.com/blogs/how-to-play/gin-rummy-game-rules
3. https://www.thesprucecrafts.com/gin-rummy-complete-card-game-rules-412366
4. https://en.wikipedia.org/wiki/Gin_rummy 





